From 3a7f79e81462f6f5fb63064e05bb28c89cfaf597 Mon Sep 17 00:00:00 2001 From: Matthias Clasen Date: Mon, 22 Nov 2010 11:15:47 -0500 Subject: [PATCH] Document border images better --- docs/reference/gtk/Makefile.am | 6 ++- docs/reference/gtk/images/border1.png | Bin 0 -> 961 bytes docs/reference/gtk/images/border2.png | Bin 0 -> 1684 bytes docs/reference/gtk/images/border3.png | Bin 0 -> 2713 bytes docs/reference/gtk/images/slices.png | Bin 0 -> 1217 bytes gtk/gtkcssprovider.c | 64 ++++++++++++++++++-------- 6 files changed, 50 insertions(+), 20 deletions(-) create mode 100644 docs/reference/gtk/images/border1.png create mode 100644 docs/reference/gtk/images/border2.png create mode 100644 docs/reference/gtk/images/border3.png create mode 100644 docs/reference/gtk/images/slices.png diff --git a/docs/reference/gtk/Makefile.am b/docs/reference/gtk/Makefile.am index 97fd4a84c8..0ce22bcf38 100644 --- a/docs/reference/gtk/Makefile.am +++ b/docs/reference/gtk/Makefile.am @@ -337,7 +337,11 @@ HTML_IMAGES = \ $(srcdir)/images/gradient1.png \ $(srcdir)/images/gradient2.png \ $(srcdir)/images/gradient3.png \ - $(srcdir)/images/gradient4.png + $(srcdir)/images/gradient4.png \ + $(srcdir)/images/border1.png \ + $(srcdir)/images/border2.png \ + $(srcdir)/images/border3.png \ + $(srcdir)/images/slices.png # Extra options to supply to gtkdoc-fixref FIXXREF_OPTIONS=--extra-dir=../gdk/html \ diff --git a/docs/reference/gtk/images/border1.png b/docs/reference/gtk/images/border1.png new file mode 100644 index 0000000000000000000000000000000000000000..92e2cc5bf2eb94fea6abfccc996106d31e72fa1b GIT binary patch literal 961 zcmeAS@N?(olHy`uVBq!ia0vp^DIm3R9Nsk+6HlSR{2)xNXKlx;OtD>4;iRZ9Ej(s*KR^V=Dj-$e4%+t0RsP&pf~Xpz=;?Ca#? z=bEPfGF>re&NYtL|Cfm0lkK;DEjaztTc2AV%wh^9v3~ zSheykHr2IjvFhVH+@|W*o@nXa!*^|S*2RNW zVQ-zUt=OJ9J70Ig6y5Tq#wD9r`s84+td3dq2mF8{DUe-xT(eGTCJU8l=D>W|R zkp(J3AtbFlQeFhC|H`|JNA?uNY6XaWOrEM$*B-oJnABB0ZJ~4G@+tZ6CnmmdFtuKq zFg*?!mW@lM8L|8~Sq2PphoCd(9-FTO`M6@a$k)w`hnYO@9^UlyoX&(0j(d-_KoSa? z=l1%)+>qKa-CAQM91^#)! zAgb&6mhj-b#M^@ojIzHBZ#6Ui4+n`T%CGr0#nbR!>5Eet{A_==?*G&|`BAog#M_;d clgjKRcz0R;e>BG)m9mKp^h1@bkOzPE;9oF2k+|Q_K&C$loow*N-$k7-&l@SpVx~Lpe zm^B@FRg}we%}^(XW6N!GcfRvFKb(Kz{O~-_=Xsvb^LgIS`}29dpKNzmM@5Ch3Lp?j z(b);@35@T7RwO3{^plz=s)0e8jB@stlam{rbejOChhpq~W4t0rG4cMTcn zIUt%y3?~Og#0aI?NDyeRfiv39JE3HL%q?8~^uf3O(T@d`EPS<%t=YsiqDM@r$yf{b z6$+cFqP?GO>QK);Tt64hi<=c@R-^G<# zC$q^zXYzS717-VLi{_ah;s?fDkleeu-OR)Y$w8f$OKT#3Gxdidy|>vpg4G*;$JaM! zoml#4IfdJfS?3#N5StM6;#qHLLfiLvHAgoQGc}Mg`+5%_s=m}M_@bH8fS{Mo9+h@t z4KX6(rssPHJEE@FDrvnIWUbv1<{V*}&@C{r*Y}_=hj#g#DMi*L)r+yXxwnFjx5*7| z26PyuUVH(E-LTsl`{<*UE5;Az7Vg|Dp+uU~aBl`C}TWRdBLEHOOF`#o^ zaJwa$?&5TL9$Whov@-$j&qNd|!3@ou!Z_eZdPmdcV{R$JOv^OnVeV-JDa~wxZXYG8 z1FYmM11aFqjA4=9CmBN`Jk5oAJ79Ujyk%74kiGBu9=m1yF-ExpQO3n00xARFO3^Wf zU?M%`jvu}zZ>z(wbp%8BHAW2huM`Q!6`5=RmI|i4a-ERAh{6)#c7jaRQyef0s-UR^ z(m)>*SJ5io;x#+M%2AMrh z+yfl&#q1GXhOMy&4h#v>52g{Mp2)#^ARO?zyaPNf9I#b5U@O2w0>_DqtrF`pUh7ma zMJy->On>k9B)Gb5#ysf2f9*{LOJdOSzkj<|aFSl*Z_Gy{1+cv*_dBZm%;Hg_% z3(2lKBjD*0@l=V$Qj22w)x@1@5;OBpXm1ZJ%6x0(E~+5l50Rl-8@1nL#IF?P+j{yU zg=@ZaoBgQ(U^FE0L9y|6md45F=Y_Ewu$5+n!}z!ZfN7tjp(D?M~SL>kdmr~E?mhGxzrrX23kBHA{fKbM| z6@8o5K8XJf_LV40ssI2K~Q9X00003b3#c}2nYz< z;ZNWI000?uMObuGZ)S9NVRB^vXKrt8Wi4}Ka%E+1b7*gL?*qR+000UsNkl z&5rE05rq$FU2nZ}HhBRrvq{!@vOHMejgcUGBah%91}<>d_hzP9Sx9126j@YDEwKiD zJ`99v4y7TfGu6c(QSR;SlXD{CLhvFkHALLkuYdji`+tf600aUz8h{f3;sj0vfCDfZ z^U=lpNrvf|=4_@fGsFwVoLPE$!Koz0^ks$z(w9ZunjRZ)S)OApbH5`_P;T⪚E9A z?X&$3mRd$2N$X{IP-&U8B!BqvkN^GsKO#tVn2K`%0w5wD2!M;mWXn77HfkCU82`Ys z^rf0Cq}I%^YS}$!)rxe@WslT-M`84)ySVP9(*ejb9jkPS$JqdY5Dn@?-LsM}MWA2)NmEc0~fOOQ{zJ@zb9J}kTAFtHh zzCxbYq>GQx^csR+1P1G0%gS|Mrn&RPank*;uetM@^qF;6^(tv#Q2aFnF=cz1&KAc> zmwo80M!Vb7+>W|Gdf6ux28v!K1_rfX2l4B`;Jo|spg6Fl|5Q(h(sw)}jvdG2P5RJT z^RLQvKkxo-se2GjucF7YA^6eDo}{^2`a|trJN-OyoOD?ub>DG(a@_@rUbR?u%OIED zaAw6(J3b_iji+C)xh_rm+`21z6>-D2uYYnrOwtxF0?f`Cf^T2{Hh%dY!Np6sBxEfm#Kv*dajfkAQiinUG1Wn@cSGI6%LUlc95oR*grx>#Zi zb>MXnI4IpO>XuxN=*wcTeAY3w>1at8R(r56#5qjc#Bz{}7((;1!?c_33?~#wcSP-9 z4Z>%?h&dV)wsf(?7Wxntm&Fis=;N}D3ESRvZNz!JzWq#<}XoVU_iRlm`YH_YU_VvhENZFID$oT*pRi?t3@ zL2@dAn4>wBP<{4`k|iCf^{*Jq5_4>gWn=ElAmn4}m&Fisw7qOpXDZXlW@JD*P*^(DsD&=!lXVm(WJjmCB%H`Ih{&N zNZ~s_6{MGX&_LmmK5W@7rq(;_Q)2SkWX~gJ;^c%aF~`>3VklW+hQ>-RMg_zcsk>Z@ zbA0xz>WBLjnY=doH$S&TCgxBcuf;f(z*v?TqZP}d@)|ozmUJQWn3*`~Wr;<$ju;d} z2SP4J?_Uk$i^S<=i5<3%7|_KMD{xs1`B-qmmV7wWz+lY62?b(@aVDV_veL^Ed$hV= zbg{%1vV8B?JzZHA69T;~=|<7HMooH@ro{k?m2@LpM1Z9xz4Fp8dRfwmRxAtdV?ZpC zxyyXSfXiZtLAH(<(8Ur9C@vOU7DEi8&lT|5FJcZ|vVOg428;@b4T_rNAQv%5)5}ho z(i6HBmXOt(JFpyt^#ashV;6$&QeyJ*lwYkl8hnQ>F-Oh6js`~zh&eXJvY?A4X3$?b zGYF>=h&fuzV&a@_v}3f;yXfQCvh&tN;*>5H#UlsUY3}nHI*=D$_y}^C7sas z)}WUq25EU&x>#Zg#l?bNmKdZlE=$Q0Yqa;5o%1m&AVz5H;>`(LVvFV=SKK=8enMhU zwWJTV?|*t(Vva`lD_s^7WlFu0jx5*6=5w}#1dbRGTQp)>QF~{E^g!!haa@*|qd8(Q zWy%cD-I88#Sq%AD==;P?%VH>5Vu!{c*XU(q*7USKX4j+JmB3 z5f^TFe-CpZWG<7;;jbixi}P$_qBPUf)6>f){~@wYPctOxQaMpS-t()Mjdd@lCoNN} zS|KJ|{pS?2Wxw5$zT#m=EP;*D?uIe=p3`+J?wMtotZ7Wgx3O$Q5l&_RDnwcHfV)#c@)TK2dW=>#n}^OT_&jqKE$o TVQCj`00000NkvXXu0mjfWsyMA literal 0 HcmV?d00001 diff --git a/docs/reference/gtk/images/slices.png b/docs/reference/gtk/images/slices.png new file mode 100644 index 0000000000000000000000000000000000000000..c0a064efbf8d99b0a8e3d238104f6d1e2c40d72d GIT binary patch literal 1217 zcmeAS@N?(olHy`uVBq!ia0vp^^MQCC2NRH7tm-cWq!^2X+?^QKos)S9vL>4nJ za0`PlBg3pY5H=O_FLRy{0dg8>|)ax7+8WmT^vIyZoQp*H}JKAKEh%udQm2%?#Si2+td-?>Ow^`qRSRZCS++h1-^VGO{rca3e;hZjumAt!M{MPd+izdix3BuY@Ok{-iWSqRpZ~SGYUiG- z^UEW}R;O=&IX}m0jnJ*%e=|Ow*%EhEx8(KzlfMpkEzC{5P!i|7%kBGmiCerSug_=y zeiL4Lm=~zE1tpBBfKU zWeKh#*&wD@dszsSd8(t#!__3^to;S%6Su2bVqx%w5)yppmm8bp`!;6z#wIT zy9Q?ld0)S*vt-<|>F@5j z>nwS<%mUMrTbh7$t&3O2)nDb-@8b=(1pVFp7Z@Hgrn2=#tQJE11^@azO%lS8u=XJ@pSJDXkP$ahoQQen(iVSH%O(b*SY zpY7-o%Rly`OM@@!X_v;uEtI z2xgq;`_HkPBh~)$vN?yPmEI^#nd>wA)A^?z8@dC&8RTYpJ@IOZZBeq%%?g|42V^a> z&CN;*2m*=OOW@PGU*D`$~oL)UKk}i{#PG`}$E-(6dQSG*AhoQ11QAqZcNr zSgcV}^1QHE$?Hj&y61(jwwooQCb3j&D@|gt)mr2NGAy~$_|rM|BeOSdoTKh(u-9Dq zcZmNUN$Jy-lURhSjZM-%K013N;@o7F8JA`+G;x&9KX$BWo{D2@SBJ{Mf2RL8tjl&> zWL3nupc@Xk;VFwH_KUx*$=`2JKZX4-%ZZ$J>hQet?~{}}*Ij=O%s*DOSLZ(}tKL*q zrmQYyn486Ox1rO`XSS5HdBP&W%gc^k;GL0iWQ*qNsg+eA{+h67FG2E~qGm1!tB-O$ zvSlU5d7qOYWh*m9foeQVUhS%!X=b`mDe0C-ryFx#+%n&tVJ<$ixn^g$Oqa-ikI3l@ i5f1KNz#Y3}Nql)Cmyaid)GlC&!{F)a=d#Wzp$PyGj6RAnother radial gradient * * This gradient was specified with - * - * -gtk-gradient (radial, + * -gtk-gradient (radial, * 0.4 0.4, 0.1, * 0.6 0.6, 0.7, * color-stop (0, #f00), @@ -456,6 +455,43 @@ * color-stop (1, @green)) * * + * + * Image slices + * + * Images can be used in 'slices' for the purpose of creating scalable + * borders. + * + * + * + * The syntax for specifying border images of this kind is: + * url(@path) @top @right @bottom @left [repeat|stretch]? [repeat|stretch]? + * The sizes of the 'cut off' portions are specified + * with the @top, @right, @bottom and @left parameters. + * The 'middle' sections can be repeated or stretched to create + * the desired effect, by adding the 'repeat' or 'stretch' options after + * the dimensions. If two options are specified, the first one affects + * the horizontal behaviour and the second one the vertical behaviour. + * If only one option is specified, it affects both. + * + * + * A border image + * This border image was specified with + * + * url("gradient1.png") 10 10 10 10 + * + * + * A repeating border image + * This border image was specified with + * + * url("gradient1.png") 10 10 10 10 repeat + * + * + * A stretched border image + * This border image was specified with + * + * url("gradient1.png") 10 10 10 10 stretch + * + * * * Supported properties * @@ -509,16 +545,16 @@ * * * font - * family [style] [size] + * @family [@style] [@size] * #PangoFontDescription * font: Sans 15; * * * margin - * width - * vertical-width horizontal-width - * top-width horizontal-width bottom-width - * top-width right-width bottom-width left-width + * @width + * @vertical-width @horizontal-width + * @top-width @horizontal-width @bottom-width + * @top-width @right-width @bottom-width @left-width * * #GtkBorder * margin: 5; @@ -532,17 +568,7 @@ * * * background-image - * -gtk-gradient (linear, - * starting-x-position starting-y-position, - * ending-x-position ending-y-position, - * [ [from|to] (color) | - * color-stop (percentage, color) ] ) - * -gtk-gradient (radial, - * starting-x-position starting-y-position, starting-radius, - * ending-x-position ending-y-position, ending-radius, - * [ [from|to] (color) | - * color-stop (percentage, color) ]* ) - * + * gradient (see above) * #cairo_pattern_t * -gtk-gradient (linear, * left top, right top, @@ -578,7 +604,7 @@ * * * border-image - * url([path]) top right bottom left [repeat|stretch]? [repeat|stretch]? + * border image (see above) * * border-image: url("/path/to/image.png") 3 4 3 4 stretch; * border-image: url("/path/to/image.png") 3 4 4 3 repeat stretch; -- 2.30.2